home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 November / macformat-030.iso / Shareware City / Developers / PICTButton CDEF 1.1 / About PICTButton < prev    next >
Encoding:
Text File  |  1995-08-04  |  2.8 KB  |  63 lines  |  [TEXT/ttxt]

  1. PICTButton CDEF version 1.1
  2. by Paul Celestin
  3. 4 August 1995
  4.  
  5. Copyright © 1994-1995 by Celestin Company, Inc.
  6. All rights reserved
  7.  
  8. PICTButton is a CDEF (control definition) that allows you to use pictures as buttons instead of the drab black and white buttons that you are used to. You can use it just about anywhere. I've tested it on various machines. I've included a sample application that shows the CDEF in action.
  9.  
  10. VERSION HISTORY
  11.  
  12. 1.1.0 - finally converted the thing over to CodeWarrior!
  13. 1.0.7 - now works over multiple monitors of different bit depths
  14. 1.0.6 - removed unnecessary erasing code
  15. 1.0.5 - really fixed problem with black and white PICTs showing up properly
  16. 1.0.4 - changed color of text in variation 2 to blue
  17. 1.0.3 - fixed a problem with black and white PICTs showing up, or so I thought
  18. 1.0.2 - fixed the new variations
  19. 1.0.1 - added variations 1 and 2
  20. 1.0.0 - initial release
  21.  
  22. INSTRUCTIONS
  23.  
  24. To use the CDEF, copy the CDEF resource into your project's resource file. 
  25.  
  26. Then, create CNTLs with the following settings:
  27.  
  28. The BoundsRect should correspond to where you want to PICT to be displayed in your dialog.
  29.  
  30. Value should be the resource ID of the PICT you want as the default for the button. For example, you might use PICT ID 1000. In this case, the following table tells you what pictures you need and what they are used for:
  31.  
  32. 1000 - default color
  33. 1001 - inverted color (when you click and hold on the control)
  34. 1002 - default black and white (for when your monitor's bit depth is 1)
  35. 1003 - inverted black and white
  36.  
  37. Visible should be set to true.
  38.  
  39. Max and Min should be set to zero, since they don't mean anything to PICTButton.
  40.  
  41. ProcID should be set to (CDEF ID * 16) + Variation. I've set the CDEF ID to 36, so in most cases, the ProcID should be set to 576. There are two additional variations available. Variation 1 will display the title of the CNTL in the center of the PICT. Variation 2 will draw a two pixel wide line around the PICT. To use variation 1, set the ProcID to 577. To use variation 2, set the ProcID to 578.
  42.  
  43. RefCon should be set to zero.
  44.  
  45. Title can be set to anything you like. It will only be used if you use variation 1.
  46.  
  47. If you do not have a PICT of a certain ID and the CDEF is looking for it, things will probably not work correctly. If PICTButton does not work on your setup, I would certainly like to hear about it.
  48.  
  49. You may use PICTButton CDEF in any public domain, freeware, shareware, or commercial product. I would appreciate a copy of any product in which it is used. Credit would also be nice, though I don't require it.
  50.  
  51. Bugs, gripes, comments, etc. should be sent to me (Paul Celestin) at one of the following addresses:
  52.  
  53. Internet (preferred): celestin@celestin.com
  54. AOL and eWorld: Celestin
  55. CompuServe: 71630,650
  56. MCI Mail: 578-6464
  57.  
  58. Snail mail:
  59.  
  60. Paul Celestin
  61. Celestin Company, Inc.
  62. 1152 Hastings Avenue
  63. Port Townsend, WA  98368